package com.xinke.module.system.service.user;

import java.util.*;
import javax.validation.*;
import com.xinke.module.system.model.vo.user.*;
import com.xinke.module.system.model.entity.user.PostDO;
import com.xinke.component.common.pojo.PageResult;
import com.xinke.component.common.pojo.PageParam;
import org.springframework.lang.Nullable;

/**
 * 岗位信息 Service 接口
 *
 * @author yzx
 */
public interface PostService {

    /**
     * 创建岗位信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createPost(@Valid PostSaveReqVO createReqVO);

    /**
     * 更新岗位信息
     *
     * @param updateReqVO 更新信息
     */
    void updatePost(@Valid PostSaveReqVO updateReqVO);

    /**
     * 删除岗位信息
     *
     * @param postId 编号
     */
    void deletePost(Long postId);

    /**
     * 获得岗位信息
     *
     * @param postId 编号
     * @return 岗位信息
     */
    PostDO getPost(Long postId);

    /**
     * 获得岗位信息分页
     *
     * @param pageReqVO 分页查询
     * @return 岗位信息分页
     */
    PageResult<PostDO> getPostPage(PostPageReqVO pageReqVO);

    /**
     * 校验岗位们是否有效。如下情况，视为无效：
     * 1. 岗位编号不存在
     * 2. 岗位被禁用
     *
     * @param postIds 岗位编号数组
     */
    void validatePostList(Collection<Long> postIds);

    /**
     * 获得符合条件的岗位列表
     *
     * @param ids 岗位编号数组。如果为空，不进行筛选
     * @param statuses 状态数组。如果为空，不进行筛选
     * @return 部门列表
     */
    List<PostDO> getPostList(@Nullable Collection<Long> ids,
                             @Nullable Collection<Integer> statuses);
}